home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 October / EnigmA AMIGA RUN 31 (1998)(G.R. Edizioni)(IT)[!][issue 1998-10].iso / earkit / chat / amtalk_13 / amtalk.doc < prev    next >
Text File  |  1998-09-22  |  16KB  |  406 lines
  1.  
  2.  
  3. AmTALK
  4. ******
  5.  
  6. Welcome to AmTALK, the AmigaOS Talk client.
  7.  
  8. Version 1.3 (14.02.97)
  9.  
  10. Copyright
  11. *********
  12.  
  13. AmTALK has been designed, developed and written by
  14.  
  15.          Oliver Wagner
  16.      Landsberge 5
  17.      D-45549 Sprockhövel
  18.      Germany
  19.      E-Mail: (owagner@vapor.com)
  20.      
  21.      All Rights Reserved.
  22.      
  23.      This document compiled by Adam Hough <adamh@spots.ab.ca>
  24.      © 1996-97 Oliver Wagner
  25.      All Rights Reserved
  26.      
  27.      Installer Script
  28.      © 1996-97 Robert Reiswig
  29.      All Rights Reserved
  30.      Brought together in a heavy overnight operation
  31.  
  32. License
  33. =======
  34.  
  35. AmTALK Registered Software License Agreement
  36. -------------------------------------------
  37. AmTALK is Copyright © 1996-97 by Oliver Wagner, All Rights Reserved.
  38. The producer of this software will grant the Licensee a limited,
  39. non-exclusive right to use the program AmTALK and it's associated files
  40. on a single machine. The producer will hand out a special
  41. identification file called the key file to the Licensee. This key file
  42. will enable the Licensee to fully use the AmTALK package according to
  43. the terms of this license.  The key file is stricly for personal use by
  44. the Licensee only. Any disclosure of they key file will invalidate the
  45. license and the key file itself. The Licensee will be held liable of any
  46. damage arising out of the disclosure of the key file.
  47.  
  48. No warranty expressed or implied. You use this software at your own
  49. risk and discretion. Any damage to you, your machine, house, universe
  50. or reality is completely your own problem. Vaporware and its related
  51. authors are not responsible for anything whatsoever that happens to
  52. you, even if the software destroys everything you hold dear. Using this
  53. software is considered to be acceptance of these terms. Ignorance is no
  54. excuse.
  55.  
  56. The product is provided as is without warranty of any kind, either
  57. express or implied, statutory or otherwise, including without
  58. limitation any implied warranties of non-infringement, merchantability
  59. and fitness for a particular purpose. The entire risk as to use,
  60. results and performance of the product is assumed by you and should the
  61. product prove to be defective, you assume the entire cost of all
  62. necessary servicing, repair or other remediation.  In no event shall
  63. the producer of this product or its resellers be liable for any
  64. property damage, personal injury, loss of use or other indirect,
  65. incidental or consequential damages, including without limitation, any
  66. damages for lost profits, business interruption or data which may be
  67. lost or rendered inaccurate, even if we have been advised of the
  68. possibility of such damages.  This agreement shall exclusively be
  69. governed by the laws of the Federal Republic of Germany.
  70.  
  71. Support
  72. =======
  73.  
  74. There is a support mailing list to discuss AmTALK related issues; write
  75. to <AmTALK-request@vapor.com> and put "ADD" in the mail body.  Please
  76. join the list if you want to report bugs or have suggestions.
  77.  
  78. About Author
  79. ============
  80.  
  81. Olli Wagner is a sausage munching German who writes really good Amiga
  82. software like amIRC and Voyager (along with several others.) This is
  83. shareware so if you like it, send Olli a large slice of bratwurst to
  84. the address in the registration info in the about window. Also send him
  85. email asking what happened to Knabber and if VNG will ever ship.
  86.  
  87. Description
  88. ***********
  89.  
  90. AmTALK is an enhanced version of the UNIX talk program. This program
  91. was the precursor of IRC in that it permitted remote users to chat with
  92. one another in real time. While IRC extends the basic functionality
  93. such that many people can talk to each other simultaneously, the basic
  94. need for a direct one on one method of communication is still there.
  95. However, using talk is rather like using the phone in that people
  96. aren't always available so wouldn't it be nice to have an answering
  97. machine.
  98.  
  99. Vaporware introduces... AmTALK.
  100.  
  101. AmTALK has the following features:
  102.  
  103.    * fully multithreaded for several talk sessions at once.
  104.  
  105.    * Auto answer facility to accept talk requests and store incoming
  106.      messages. Can be triggered manually or by a user-definable
  107.      timeout. Optional auto answer information icon on workbench
  108.      displaying number of new and unread messages.
  109.  
  110.    * "Locate" function to locate a user on a dynamic IP address even if
  111.      you don't know which IP he is using right now.
  112.  
  113.    * History of last used talk addresses for easy access.
  114.  
  115.    * user configurable sounds for notifying of incoming talk requests
  116.      and successfully established talk links.
  117.  
  118.    * Userlist to store frequently used talk partners, with aliasing for
  119.      easy talk start and specificable access privilleges (override auto
  120.      answer, refuse/ignore always, locate always etc.)
  121.  
  122.    * Can be started from inetd, or reside resident in the background,
  123.      activated by hotkey.
  124.  
  125.    * Supports clipboard Cut & Paste from talk windows.
  126.  
  127.    * Keeps a full log of incoming talk requests.
  128.  
  129.    * nice and friendly GUI to start talks, control operation and
  130.      configuration.
  131.  
  132.    * handles incoming talk requests with "wrong" usernames gracefully.
  133.  
  134.    * works with Miami, AmiTCP and as225r2-derived TCP/IP stacks.
  135.  
  136. Installation
  137. ************
  138.  
  139. The easiest way of installation is of course using the provided
  140. Installer script.  Note that the provided Installer script doesn't work
  141. with the old OS 1.3 1.24/1.25 versions of Installer.  Please get
  142. Installer-43_3.lha from AmiNet (/util/misc) or from ftp.vapor.com,
  143. /pub/misc/Installer-43_3.lha.
  144.  
  145. You may also want to add this to your startnet or startup.miami script:
  146.  
  147.      IF  SHOW('P','AmTALK')  THEN DO   /* Already there */
  148.          DELAY(5)
  149.      END
  150.      ELSE DO
  151.              ADDRESS COMMAND 'run >nil: AmTALK '
  152.      END
  153.  
  154. This means that the program will be run automatically when you start up
  155. your TCP/IP stack so the ability to handle incoming chat requests will
  156. be there automatically.
  157.  
  158. AmTALK can also be started from inetd "on demand". Add the following
  159. line to your inetd.conf file:
  160.  
  161.     ntalk           dgram   udp wait  root    <path>AmTALK
  162. <path>AmTALK identd=1
  163.  
  164. Note that you have to specify the full path to the AmTALK executable,
  165. and it's right that you have to specify it twice.
  166.  
  167. Your identd will then start AmTALK when a talk requests comes in.
  168.  
  169. Running the program
  170. *******************
  171.  
  172. In order to talk with someone, you can either use the provided
  173. talk rexx starter program. Simply type
  174.  
  175.     talk user@host
  176.  
  177. from a shell window.
  178.  
  179. Also, when started manually, you will be presented with the Talk
  180. window, which is thoroughly explained in the next section. When AmTALK
  181. is lurking in the background, you can open it everytime with the
  182. specified hotkey. This defaults to ramiga t.
  183.  
  184. The GUI
  185. *******
  186.  
  187. The default window opened up gives you access to the address of the user
  188. you'd like to speak to, a drop down window (an arrow pointing to a line)
  189. which is a history of people you've talked to in the past so you don't
  190. have to type their addresses in again.
  191.  
  192. Underneath that are three buttons.
  193.  
  194.     Talk This opens up a direct chat to the person specified in the
  195. address field above.
  196.  
  197.     Locate and Talk This allows you to 'find' a person on a dynamic
  198. link such as those provided by most ISPs. It also needs a full address
  199. but will search through all the addresses in that level of addressing
  200. until it finds the person you'd like to talk to. It can take a little
  201. bit more time though.
  202.  
  203.     Userlist This brings up another menu that allows you to enter
  204. aliases for addresses - similar in style to the way Mail programs do
  205. it. This means that you can type in "Olli" rather than
  206. "olli@hurz.wupper.de" at the address line.
  207.  
  208. Once you've chosen to talk another window comes up which is the chat
  209. window itself. This is dominated by two sections - the top one which
  210. contains what your chatee has to say to you and the lower one which is
  211. what you're saying to them.  Scroll bars on both allow you to look at
  212. what's moved off the top of the screen. In the dragbar at the top is
  213. the address of the person you're talking to.
  214.  
  215. The Talk Received Window:
  216. =========================
  217.  
  218. This pops up when someone else tries to start a Talk session with you.
  219.  
  220.     Ignore Press this if you don't want to talk to the person. He
  221. will get a message stating that you're not available.
  222.  
  223.     Ignore Always Press this if you never want to talk to the person
  224. ever again. He will get a message stating that you're never available.
  225.  
  226.     Refuse Press this if you don't want to talk to the person. He will
  227. get a message stating you're ignoring incoming requests.
  228.  
  229.     Refuse Always Press this if you never want to talk to the person
  230. ever again. He will get a message stating you're ignoring incoming
  231. requests.
  232.  
  233.     Answering Machine Route the call to the answering machine.
  234.  
  235.     AA Always Always route this person's calls to the answering
  236. machine.
  237.  
  238.     Accept Start the talk session.
  239.  
  240. The Menu Bar
  241. ============
  242.  
  243.     Start Talk This brings up the window mentioned earlier on and
  244. allows you to have multiple talk sessions going on with other people at
  245. the same time.
  246.  
  247.     Review AA Messages This is a list of all messages that have been
  248. sent to you while you've been away from your computer. It tells you the
  249. address of the talkee, when the chat attempt happened, how long the
  250. message was and whether you've read it or not. The window to the bottom
  251. contains the text of the message. The three buttons at the bottom allow
  252. you to start a talk session with the person who left the message. If
  253. you double click on the name that two will start a chat session with
  254. the person who left the message.
  255.  
  256.     Review Log This is a list of all the chat sessions that have been
  257. started recently and list the time, date, addressee and what happened
  258. to the session. The three buttons at the bottom allow you to delete the
  259. list that's stored, or talk to the originator again.
  260.  
  261.     Copy to Clipboard Copy selected contents of the current window to
  262. the clipboard.
  263.  
  264.     Paste From Clipboard Copy the contents of the clipboard to the
  265. talk session. The contents must be ascii format.
  266.  
  267.     [1] xxxxxx This is a list of all the current talk sessions in
  268. progress.  To just to the appropriate one, just choose the option.
  269.  
  270. Configuration
  271. =============
  272.  
  273. Hotkey
  274.      Set the keyboard option that you want to call up AmTALK.  This
  275.      defaults to ramiga t
  276.  
  277. Colors
  278.      here you can set the colour of your text and background.  Click on
  279.      the line to bring up the options for changing them.
  280.  
  281. Sounds
  282.      AmTALK can play samples for when a connection is attempted and for
  283.      when it succeeds. Type the location of the sound files or use the
  284.      document button to bring up a file requester. The number refers to
  285.      the replay speed and typically changes to an appropriate value
  286.      automatically. Test allows you to try out the sample.
  287.  
  288. AutoAnswer
  289.      In the text window to the top, you can type in the message that
  290.      people will get when they try to reach you if you're not paying
  291.      attention, don't want to talk to them and so on. The two sliders
  292.      set how long their message can be and how long it'll take the
  293.      answering machine to kick in.
  294.  
  295. UserList:
  296.      See the section about this earlier on.
  297.  
  298. MUI:
  299.      Set your preferences for all MUI related gagetry in this program.
  300.      Read the MUIPrefs documentation for further details.
  301.  
  302. Show AA Infowindow:
  303.      This is a tiny little window that displays messages left for you
  304.      to read in the format "read messages/unread messages" - double
  305.      clicking on it brings up the AutoAnswer message window documented
  306.      earlier.
  307.  
  308. Snapshow AutoAnswer Window:
  309.      This ensures the program remembers where you left the window.
  310.  
  311. Auto Answer All:
  312.      This means that the Answering Machine handles all incoming calls
  313.      rather than bringing up the Talk requester so you aren't bothered
  314.      by them.  The default is off so you get the option of answering
  315.      people's chat requests.
  316.  
  317. AREXX
  318. *****
  319.  
  320. In addition to the standard MUI Arexx commands, AmTALK provides the
  321. following two commands:
  322.  
  323.     talk
  324.  
  325. Template: RemoteUser/A,RemoteHost/A,RemoteTTY,Locate/S
  326.  
  327.     findalias
  328.  
  329. Template: AliasName/A
  330.  
  331. Locate
  332. ******
  333.  
  334. Many people seem to have problems understanding how the "Locate and
  335. Talk" facility in AmTALK works, so I try to give a more thorough
  336. explanation.
  337.  
  338. One of the reasons that the talk protocol went out of fashion recently
  339. is tied to the more and more advancing usage of dynamic IP addresses.
  340.  
  341. Since you must know the exact host name of a party you want to "talk"
  342. to, it's nearly impossible to talk to someone which normally uses a
  343. dynamic IP address without a means of finding out the address he
  344. currently uses.
  345.  
  346. You can, for example, find this out if you meet in IRC, but it's pretty
  347. pointless to use talk if you could use the more efficient DCC CHAT
  348. anyway.
  349.  
  350. AmTALK tried to provide a solution to this problem, the so-called
  351. "Locate facility".  How does it work?
  352.  
  353. Let's assume you want to talk to MrFitz, which ISP's has the domain
  354. "ifx.net".  ifx.net provides dynamic IP addresses to it's users, so
  355. everytime MrFitz logs on, he gets a different host name -
  356. "ip69.ifx.net", "ip42.ifx.net" etc.
  357.  
  358. So, when you want to talk to MrFitz, you don't know which address he's
  359. currently using.  Locate, however, does the trick of asking all of the
  360. potential IPs he may be on for a user with the name of "MrFitz", and if
  361. you're lucky, the correct AmTALK at the remote end will respond with
  362. "Here I am!" and voilá, you know where to talk to.
  363.  
  364. Actually, in order for "Locate" to work, you must know at least one of
  365. the IP addresses that MrFitz normally has - you might have gotten it
  366. from the last time you saw him on IRC, or when he "talk"ed to you etc.
  367. You can't use "*.ifx.net" or just "ifx.net" as a anchor address to
  368. Locate, btw - it must be a valid hostname which results in a IP address
  369. record.
  370.  
  371. Also, you must know the exact username that he uses at his end, because
  372. this is the anchor at which the identification takes place.  If you try
  373. to locate "mike@ip42.ifx.net", you will fail, because his AmTALK will
  374. only responds to queries for the username "Mike".  The local username is
  375. normally equivalent to the email name of the person, or the username in
  376. his IRC userhost address.  If you are unsure, just ask.
  377.  
  378. Technically, "Locate" works by assuming that the ISP gives out all his
  379. Dynamic IP addresses from within a single Class-C network.  It takes the
  380. host name you feed to it, masks out the network part and then queries
  381. all 254 IP addresses of this net with a short UDP packet bearing the
  382. username.  If the correct site is hit, it will respond with a
  383. acknowledge packet.  This is a very brute force approach to the
  384. problem, but has the advantage of not relying to any global or
  385. ISP-local "talk hostname servers".  The bandwidth waste caused by the
  386. packet flood is comparable to WWW or usenet comp.sys.*.advocacy
  387. hierarchies, and therefore "Locate" should not be used lightly.
  388.  
  389. Index
  390. *****
  391.  
  392.  
  393.  
  394.  ARexx commands                         AREXX
  395.  Configuration                          The GUI
  396.  Contents, Table of                     Top
  397.  Copyright Information                  Copyright
  398.  Description                            Description
  399.  Features                               Description
  400.  GUI                                    The GUI
  401.  Installation                           Installation
  402.  Support                                Copyright
  403.  TALK protocol                          Description
  404.  The Locate function                    Locate
  405.  
  406.